home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / sysgn132.zip / SYSGEN.DOC < prev    next >
Text File  |  1989-12-11  |  15KB  |  371 lines
  1.     ------------------------------------------------------------------------
  2.  
  3.     Sysgen V1.32 - Roger Link 12/11/89
  4.  
  5.     ------------------------------------------------------------------------
  6.  
  7.     The Link sysgen program is a utility to help configure and maintain
  8.     MS-DOS configurations files.  Through the use of a sysgen configuration
  9.     file, the program can generate files such as AUTOEXEC.BAT and
  10.     CONFIG.SYS for different system needs.  This can be very useful if you
  11.     are constantly tampering with your autoexec.bat and config.sys because
  12.     one program wants this or that, and "this or that" interferes with
  13.     everything else in the system.  Some programs want extended memory,
  14.     others want expanded.  Some things (like LAN programs) have large
  15.     device drivers, or some device drivers refuse to coexist with another.
  16.     With this program, you can change system configuration files by simply
  17.     issuing a command (with a value indicating the number of the system
  18.     desired), and rebooting the computer.  Sysgen also has a simple menu
  19.     system to prompt the user for the sysgen value to determine which
  20.     system to build.  Sysgen allows for up to nine different systems to be
  21.     stored in a single configuration file (Multiple configuration files are
  22.     allowed.).  A utility is included to read your current autoexec.bat and
  23.     config.sys into a configuration file ready for sysgen.
  24.  
  25.     The sysgen configuration file is a line oriented file, read from left
  26.     to right.  The primary use of each line is determined by the first
  27.     character in the line.  The two most important "commands" are the "F"
  28.     and the "-".  The "F" file command determines where the following data
  29.     lines will be output.  The "-" indicates a data line.  The nine
  30.     characters following either of these commands determine which of the
  31.     nine system(s) will use that line.  For example:
  32.  
  33.            -12     8 Path C:\;C:\system;
  34.  
  35.      This "-" data line would only be used with a sysgen value of 1,2 & 8.
  36.  
  37.     Another example shows how the path can be changed for each system:
  38.  
  39.            -1        Path C:\sys\dos;C:\Fred;
  40.            - 2       Path C:\sys\dos;C:\Andy;
  41.            -  3      Path C:\sys\dos;C:\Allen;
  42.  
  43.     The actual characters used in columns 2-10 aren't important, just
  44.     their position.  In the above example the "1", "2", "3" would have
  45.     worked just as well if they had been "X"'s.  The sysgen program checks
  46.     each position for a space/no space test.  I use numbers since they are
  47.     equal to the sysgen value.
  48.  
  49.     A more complete sysgen configuration file follows:
  50.  
  51.            F123456789C:\autoexec.bat
  52.            -1        Path C:\sys\dos;C:\Fred;
  53.            - 2       Path C:\sys\dos;C:\Andy;
  54.            -  3      Path C:\sys\dos;C:\Allen;
  55.            -123      Chkdsk /f
  56.            - 2       cd \Kermit
  57.            - 2       Kermit
  58.            F123456789C:\config.sys
  59.            -12       device = C:\sys\dos\ansi.sys
  60.            -  3      device = C:\sys\public\sansi.sys
  61.            -123456789files=20
  62.            -123456789buffers=20
  63.  
  64.     This example shows the use of the "F" file command.  The "F" command
  65.     names the output file to put the following data lines in.  For example
  66.     if sysgen was run with the above configuration file, the following
  67.     output files (autoexec.bat & config.sys) would be produced depending on
  68.     the sysgen value input to the sysgen program.
  69.  
  70.     Sysgen Value = 1
  71.  
  72.         C:\autoexec.bat would contain
  73.            Path C:\sys\dos;C:\Fred;
  74.            Chkdsk /f
  75.  
  76.         C:\config.sys would contain
  77.            device = C:\sys\dos\ansi.sys
  78.            files=20
  79.            buffers=20
  80.  
  81.  
  82.     Sysgen Value = 2
  83.  
  84.         C:\autoexec.bat would contain
  85.            Path C:\sys\dos;C:\Andy;
  86.            Chkdsk /f
  87.            cd \Kermit
  88.            Kermit
  89.  
  90.         C:\config.sys would contain
  91.            device = C:\sys\dos\ansi.sys
  92.            files=20
  93.            buffers=20
  94.  
  95.     Sysgen Value = 3
  96.  
  97.         C:\autoexec.bat would contain
  98.            Path C:\sys\dos;C:\Allen;
  99.            Chkdsk /f
  100.  
  101.         C:\config.sys would contain
  102.            device = C:\sys\dos\sansi.sys
  103.            files=20
  104.            buffers=20
  105.  
  106.     The "E" echo primary command will conditionally echo the data portion
  107.     of the line to the user while sysgen is interpreting the configuration
  108.     file.  Columns 2-9 determine which sysgen value(s) will trigger this
  109.     line to be echoed as sysgen builds the output files:
  110.  
  111.           E1        ** Disk Cache System Sysgen **
  112.           E 2       ** Turbo Debug Sysgen **
  113.           E  3      ** EasyNet System Sysgen **
  114.  
  115.  
  116.     The "." primary command is a meta command, with column 2 determining the
  117.     function of the line.  There are two (oh boy!!) functions.  A ";" is a
  118.     comment line with no sysgen action, and a "E" is a unconditional echo
  119.     to the user.
  120.  
  121.           .;********************************************************
  122.           .;*
  123.           .;* SYSTEM.CFG for Gem 20mhz '386
  124.           .;*
  125.           .;*   RAL - 12/08/89
  126.           .;*
  127.           .;********************************************************
  128.           .E SYSTEM.CFG - RAL - 12/08/89
  129.           .;23456789
  130.  
  131.     When the above is interpreted by sysgen, the only visible response will
  132.     be a echo to the user of the "SYSTEM.CFG - RAL - 12/08/89" message.
  133.  
  134.     Here is a quick command summary:
  135.  
  136.     F1        C:\autoexec.bat            - "F"  File select line
  137.  
  138.     -1        Path c:\                   - "-"  Data line
  139.  
  140.     V1        ** Variable line **        - "V"  Variable line
  141.  
  142.     E1        ++ Conditional Echo ++     - "E"  Conditional echo
  143.  
  144.     .;* This is a comment line           - ".;" Comment line
  145.  
  146.     .E $$ Unconditional Echo $           - ".E" Unconditional echo
  147.  
  148.  
  149.     ------------------------------------------------------------------------
  150.  
  151.     The sysgen command has the following syntax:
  152.  
  153.       SYSGEN [-Ffilename.type] [-Q] [-?] [?] [#]
  154.  
  155.        - Square brackets "[ ]" indicate an option
  156.        - filename.type is the configuration file to use
  157.        - # is the sysgen value in the range 0-9
  158.        - ALL OPTIONS MUST have spaces proceeding and preceding that option
  159.  
  160.  
  161.     A "sysgen" with no parameters will enter "query" mode, and ask the user
  162.     for a sysgen value.  Sysgen will search the sysgen.cfg (When used with
  163.     no parameters, sysgen will default to sysgen.cfg.) configuration file
  164.     for all "V" variable lines to make up a menu for the user.  Columns
  165.     2-10 indicate what sysgen value(s) this "V" line is intended for, and
  166.     what menu select number(s) to show with the line.  When the user
  167.     replies to the prompt, he can only enter sysgen values that a "V"
  168.     variable has selected as available.  Sysgen will automatically add a
  169.     menu line for the "0"/"No system" sysgen value (and allow a zero input
  170.     to select it!!).  Here is a example configuration file, and the menus
  171.     that will be produced:
  172.  
  173.       SYSGEN.CFG file:
  174.           V1        ** Fred's System **
  175.           V 2       ** Andy's System **
  176.           V  3      ** Allen's System **
  177.           V   4     --- Autocad System ---
  178.  
  179.  
  180.       Sysgen menu produced:
  181.           0  ** NO autoexec.bat / NO config.sys
  182.           1  ** Fred's System **
  183.           2  ** Andy's System **
  184.           3  ** Allen's System **
  185.           4  --- Autocad System ---
  186.  
  187.             Enter number of system desired ->
  188.  
  189.  
  190.     No error checking is done on the variable "V" lines. It is
  191.     possible to have more than one sysgen value per "V" line as:
  192.  
  193.       SYSGEN.CFG file:
  194.           V12       ** Multiple V's per line **
  195.  
  196.       Sysgen menu produced:
  197.           0  ** NO autoexec.bat / NO config.sys
  198.           1 2 ** Multiple V's per line **
  199.  
  200.             Enter number of system desired ->
  201.  
  202.  
  203.     It is also permissible to have a variable "V" line with no sysgen
  204.     value.  This will output as a "comment" line in the menu area.  If a
  205.     sysgen configuration file other than the default sysgen.cfg is desired
  206.     in the query mode, use the